home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / Online / opennap / FAQ < prev    next >
Text File  |  2001-06-08  |  4KB  |  87 lines

  1. Frequently Asked Questions (FAQ) about opennap
  2. ==============================================
  3. Last updated on January 6, 2001.
  4.  
  5. Q:  What is opennap?
  6. A:  opennap is an open source server which speaks the napster protocol
  7.  
  8. Q:  What is napster?
  9. A:  See www.napster.com for information.
  10.  
  11. Q:  Is this project associated with napster.com?
  12. A:  No, this server was developed without any communication with napster.com
  13.  
  14. Q:  Why can't I connect to the Napster.com servers?
  15. A:  We are not affiliated with Napster, Inc.  You should contact them for
  16.     assistance.
  17.  
  18. Q:  What language is opennap written in?
  19. A:  ANSI C.
  20.  
  21. Q:  How do I get more than 256 connections under Windows?
  22. A:  Upgrade to version 0.38, it supports up to 1024 connections.  Note that
  23.     this is a compiled in defalt for the distributed binary.  If you have
  24.     Visual C++ you can edit the project file and make this value larger if
  25.     you wish.
  26.  
  27. Q:  How do I get more than 256 connections under *nix systems?
  28. A:  On some systems without a poll() function, the maximum number of file
  29.     descriptors that a process can have is controlled by the FD_SETSIZE
  30.     macro.  If you only have select(), try rerunning configure with the
  31.     --fd-setsize=1024 option to specify a higher value.
  32.  
  33. Q:  How do I get more than 1024 connections under Linux?
  34. A:  You can set the per-process file descriptor limit dynamically by piping
  35.     an integer to /proc/sys/fs/file-max
  36.     (eg.  echo 8192 > /proc/sys/fs/file-max).  The default value seems to
  37.     4096 which should be good enough.
  38.  
  39.     In order to utilize more than 1024 file descriptors, you must run
  40.     opennap as root.  Set your `connection_hard_limit' variable to something
  41.     higher than 1024 and you should be set.
  42.  
  43. Q:  Isn't running opennap as root a security risk?
  44. A:  Running anything as root can potentially be a security risk.  Opennap
  45.     attempts to reduce the risk by allowing you to specify the default
  46.     uid/gid to run as.  After setting the max file descriptors, opennap
  47.     calls setuid() and setgid() to drop root privilege (by default it uses
  48.     user nobody, group nobody).
  49.  
  50. Q:  Why do I get disconnected when I browse a user with many shared files?
  51. A:  By default, OpenNap will only queue up to 100kbytes of data for a user
  52.     to prevent a huge backlog of data for a dead/slow client.  A user with
  53.     1000 shared files will often create more than 100kbytes of output, which
  54.     triggers the dead client detection to prevent using too much resources.
  55.  
  56. Q:  How do I fix it?
  57. A:  If you have memory to spare, you can increase the value of
  58.     client_queue_length, or alternatively decrease the number of files
  59.     returned by a browse command (max_browse_result) so that it does not cross
  60.     the 100kbytes default limit.
  61.  
  62. Q:  How do I get my server listed on napigator.com?
  63. A:  Go to www.napigator.com and look for the section on adding servers.
  64.  
  65. Q:  How do I link my server to other servers?
  66. A:  Find the people who run the server you want to link with and discuss it
  67.     with them.  If both parties agree you exchange a password and follow
  68.     the directions in the README for linking up.
  69.  
  70. Q:  Under Windows, I see
  71.     handle_connection(): read: Unknown error (errno 10054) for host 
  72.     whenever a client attempts to connect to the server.  How do I fix this?
  73. A:  Remove or comment out (by placing a # in front of the line) the line in
  74.     your config file (typically C:\opennap\config) that begins with
  75.     `listen_addr'.  You can use any text editor to accomplish this.
  76.  
  77. Q:  How do I compiled OpenNap with Visual C++ under Windows?
  78. A:  You need to get DLLs for zlib from http://www.winimage.com/zLibDll/.
  79.     You want zlib113.zip and zlib113adll.zip.  Make sure to unzip them in
  80.     the *parent* directory of OpenNap, so that the directory tree looks like
  81.     this:
  82.         zlib/
  83.     opennap-0.xx/
  84.     NOTE: you DO NOT want to unzip zlib in the *same* directory as the
  85.     OpenNap source, because the project file will not be able to find them
  86.     there.
  87.